[[!toc levels=6]]

[[!map pages="wiki/ikiwiki/*"]]

---

# Instrucoes

Edite a wiki com informação factível. Mantenha opiniões pessoais na página de [[discussao]], e caso não concorde com alguma coisa, problematize na [[discussao]] da respectiva página.

Caso não esteja conseguindo editar, verifique o [[tutorial para editar a wiki|/tutorial/editar_a_wiki/]].

---

# Espelhos

[[Esta|index]] [[/ikiwiki]] é atualizada (ou deveria ser) nos seguintes repositórios remotos:

* *https://notabug.org/iikb/iikb.org*
* *ssh://www-data@lv1.midiacapoeira.in:22/var/www/iikb.git*

---

# Ikiwiki

Documentação embutida: [[/ikiwiki]]  

Instalar ikiwiki localmente: <https://tails.boum.org/contribute/build/website/>  

Instalar ikiwikis distribuídas: <https://ikiwiki.info/tips/distributed_wikis/>  

[[Automatizar espelhamento da ikiwiki|/tutorial/Espelhar_ikiwiki]]

## Clonar esta ikiwiki em um sistema debian

### Instalar ikiwiki

    sudo apt-get install ikiwiki

### Clonar repositorio

    # Altere o caminho do repositorio de acordo com instrucoes especificas
    REPOSITORIO="https://notabug.org/iikb/wiki"
    git clone "${REPOSITORIO}"

### Instalar dependencias do Perl

    sudo apt-get install cpanminus
    cpanm XML::Writer Net::DNS::SEC Sort::Naturally IkiWiki::Plugin::gitpush Text::MultiMarkdown

#### Xapian

    sudo apt-get install libxapian-dev g++
    cpanm Search::Xapian

### Criar wiki

    # Assumindo que o repositorio foi clonado em 'wiki'
    ikiwiki --setup wiki/wiki.setup

Siga as instrucoes do terminal.

#### Problemas conhecidos

Um problema sabido e que o repositorio local vai ser gravado no arquivo *.setup* com o nome errado. A forma de corrigir isto e alterando manualmente o arquivo.
Edite o arquivo gerado (padrao `wiki/.ikiwiki/wiki.setup`) e altere a seguinte linha:

    srcdir: /home/user/2wiki

Para:

    srcdir: /home/user/wiki

E depois atualizar a wiki:

    ikiwiki -setup wiki/.ikiwiki/wiki.setup

### Atualizando mudancas

    # Assumindo que a wiki foi clonada em 'wiki'
    cd wiki
    git add -A
    git commit -am "Mais uma wiki na rede!"
    git remote rename origin upstream
    # Assumindo que o repositorio da wiki esta em '/home/user/wiki.git'
    git remote add origin "${HOME}/wiki.git"
    git push origin master

#### Problemas conhecidos

Caso `git push origin master` falhe, e necessario primeiro fazer merge com o repositorio de origem:

    git pull origin master

Agora e necessario verificar quais arquivos estao criando conflitos, resolver os conflitos e entao:

    git commit -a
    git push origin master

### Para enviar alteracoes para a wiki mae

    git push upstream master

### Atualizando a wiki

    # Assumindo diretorio padrao
    ikiwiki -setup ${HOME}/wiki/.ikiwiki/wiki.setup

---

# Frontend

## Tema para ikiwiki em bootstrap

[[Discussão na wiki|/wiki/Tema_bootstrap]]

---

# Manutenção

## Instalação

`TODO`: Documentar instalação da ikiwiki antes que eu me esqueça.

### Debian

    sudo apt-get install ikiwiki ikiwiki-hosting-web spawn-fcgi fcgiwrap

### [[Systemd]]

### Nginx

TODO: Documentar arquivo de configuração do Nginx

### Perl

    sudo apt-get install cpanminus

Módulos instalados:

* XML::Writer
* Net::DNS::SEC
* Sort::Naturally
* Search::Xapian
* IkiWiki::Plugin::gitpush
* Text::MultiMarkdown

#### Fazendo a busca funcionar no Debian

    sudo apt-get install libxapian-dev g++
    sudo cpanm Search::Xapian

## [[Ikisite]]

## [[Zeronet]]

## [[SSL]]

## Administração da ikiwiki

O modelo que eu costumava usar era um subdiretório [[wiki]] e outro [[blog]], vou ver no manual da ikiwiki que outros recursos tem que eu não lembro.

Coloquei tambem um sub diretorio para tutoriais e outro para projetos. Migrei o forum para a wiki. Nao fiz um issue tracker para tarefas.

### Problemas

* [[/wiki/Plugin_404]]

[[!meta title="Ikiwiki"]]

